home *** CD-ROM | disk | FTP | other *** search
/ Logiciels PC Special 3 / Logiciel PC - Hors-Serie 3.iso / Logs / consoles / neogeo / AKBMame / SEAL.TXT < prev    next >
Text File  |  1998-12-29  |  11KB  |  256 lines
  1.  
  2. Synthetic Audio Library (SEAL) Development Kit
  3. Copyright (C) 1995, 1996, 1997, 1998 Carlos Hasan
  4. All Rights Reserved
  5.  
  6. OS/2 Sound Driver Copyright (C) 1998 Martin Amodeo
  7.  
  8.  
  9. This 1.0.6 release of the Synthetic Audio Library (SEAL) lets you write
  10. applications that conform to the 1.0 SEAL API which is able to play
  11. digital audio waveforms and music modules on many platforms.
  12.  
  13.  
  14. What's New
  15. ----------
  16.  
  17.     - New Mixer API to change the master volume level settings.
  18.  
  19.     - New Update Audio API for better sound synchronization.
  20.  
  21.     - Workaround to get sound on SB "compatible" cards. If you do not
  22.       hear sounds with your SB clone card, force SEAL to use a lower
  23.       card model changing the "T" parameter of the BLASTER variable:
  24.  
  25.                   T1 = Sound Blaster 1.0
  26.                   T2 = Sound Blaster 1.5
  27.                   T3 = Sound Blaster 2.0
  28.                   T4 = Sound Blaster Pro
  29.                   T6 = Sound Blaster 16
  30.  
  31.       For example, if you want to force a Sound Blaster 1.5 model you
  32.       have to change the BLASTER variable typing something like:
  33.  
  34.                   SET BLASTER=A220 I5 D1 T2
  35.  
  36.     - Fixed ENSONIQ SoundScape DOS drivers to work with AudioPCI chipsets
  37.       found in ENSONIQ AudioPCI and Creative PCI64 sound cards. Now SEAL
  38.       should work when these cards are in Legacy mode (Thanks Bomb!).
  39.  
  40.     - New ports to Intel BeOS Release 4 and OS/2 Presentation Manager
  41.       operating systems. See the file README.OS2 for more details about
  42.       the OS/2 port (Thanks Marty!).
  43.  
  44. Features
  45. --------
  46.     - simple and powerful API interface
  47.     - 32 simultaneous digital audio channels
  48.     - smooth pitch shifting, volume and panning controllers per channel
  49.     - smart digital filtering for improved sound quality
  50.     - efficient digital audio waveform mixing algorithms combined with 
  51.       uncompromising low-level optimizations
  52.     - importing of wave and music file formats such as Protracker 1.1,
  53.       MultiTracker 1.0, Scream Tracker 3.0 and FastTracker 2.0 modules
  54.     - performance tuned for the i486 and Pentium processors
  55.     - native support in DOS for hardware wavetable accelerators such
  56.       as the Sound Blaster AWE32, Gravis Forte's UltraSound, and normal 
  57.       digital audio devices such as the Sound Blaster 1.5/2.0/Pro/16, 
  58.       Pro Audio Spectrum 16, Windows Sound System, Ensoniq Soundscape 
  59.       and Aria soundcards
  60.  
  61.  
  62. Supported platforms
  63. -------------------
  64. The SEAL SDK is available for DOS, Extended DOS, Windows 95, Windows NT,
  65. OS/2, BeOS and Linux platforms. FreeBSD, SPARC SunOS, SPARC Solaris and
  66. SGI Indigo ports are in progress. The following compilers were used to
  67. build the library files:
  68.  
  69.     - Borland C++ 4.5 compiler for DOS and Win32s
  70.     - WATCOM C/C++ 10.0 compiler for DOS and Windows
  71.     - Microsoft Visual C++ 4.1 compiler for Windows 95
  72.     - DJGPP 2.0 port of GNU C/C++ compiler for DOS
  73.     - GNU C/C++ 2.7.0 for Linux (a.out and ELF)
  74.     - Metrowerks CodeWarrior C++ for Intel BeOS Release 3
  75.     - EMX port of GNU CC 2.7.x for OS/2 platforms
  76.  
  77.  
  78. The SEAL SDK contains
  79. ---------------------
  80.     - SEAL API header and library files
  81.     - SEAL audio library source code files (commercial license)
  82.     - set of example source code files
  83.  
  84.  
  85. ---------------------------------------------------------------------
  86. IMPORTANT: Please make sure you understand the Copyright and License
  87. information (in the file named LICENSE.TXT) before using this release.
  88. ---------------------------------------------------------------------
  89.  
  90.  
  91. Installing the Software
  92. -----------------------
  93. The SEAL SDK can be installed unpacking the distribution archive
  94. in your hard disk. For example,
  95.  
  96.     C:\>PKUNZIP -d SEAL106.ZIP
  97.  
  98. The SEAL SDK include and library directories can be installed in 
  99. your C programming environment modifying the header and library 
  100. directory paths. Here are some examples to compile and link
  101. the SEAL audio system library with your own programs:
  102.  
  103.     - WATCOM C/C++32 10.0 and DOS4GW DOS Extender:
  104.       wcl386 -I\audio\include example.c \audio\lib\dos\audiowcf.lib
  105.  
  106.     - DJGPP 2.0 port of GNU CC for DOS/DPMI32:
  107.       gcc -I\audio\include -o example example.c \audio\lib\dos\audiodjf.a
  108.  
  109.     - Visual C/C++ 4.1 for Windows 95 and Windows NT:
  110.       cl -DWIN32 -I\audio\include example.c \audio\lib\Win32\audw32vc.lib
  111.  
  112.     - Borland C++ 4.5 for Win32s:
  113.       bcc32a -WC -I\audio\include example.c \audio\lib\Win32\audw32bc.lib
  114.  
  115.     - GNU CC 2.7.0 for Linux (ELF binaries):
  116.       gcc -Iaudio/include -o example example.c audio/lib/Linux/libaudio.a
  117.  
  118.     - Metrowerks CodeWarrior C++ for BeOS R3:
  119.       mwcc -Iaudio/include -o example example.c audio/lib/BeOS/libaudio.a
  120.  
  121. The above examples assume that the audio system was installed at the 
  122. root directory of the current drive. For Windows 95 and Windows NT 
  123. applications you must copy the AUDIOW32.DLL dynamic-link library into 
  124. the Windows system directory, usually located at C:\WINDOWS\SYSTEM in
  125. your hard disk.
  126.  
  127.  
  128. Notes about DOS Drivers
  129. -----------------------
  130. For applications running in DOS, the audio system will try to detect
  131. the hardware sound devices installed on your system. Since there can
  132. be problems to autodetect your sound hardware, your application should
  133. provide a way to force the use of a particular audio device driver.
  134.  
  135. Here is a list of notes for the autodetection methods used by the audio
  136. device drivers under the DOS operating system:
  137.  
  138.     - Sound Blaster 1.0/1.5/2.0/Pro/16 device drivers:
  139.       These drivers use the BLASTER environment variable to determine
  140.       the hardware I/O base port address, IRQ interrupt line and DMA
  141.       channels. The model of the card is then determined by hardware
  142.       reading the DSP version number. If you do not get sound, try
  143.       forcing other SB model by using the "T" parameter of the BLASTER
  144.       environment variable:
  145.  
  146.                   T1 = Sound Blaster 1.0
  147.                   T2 = Sound Blaster 1.5
  148.                   T3 = Sound Blaster 2.0
  149.                   T4 = Sound Blaster Pro
  150.                   T6 = Sound Blaster 16
  151.  
  152.     - Sound Blaster AWE32 and Sound Blaster 32 device drivers:
  153.       The driver uses the BLASTER environment variable, you must
  154.       specify the EMU8000 I/O base port address parameter. If your
  155.       card does not have DRAM local sound memory, you must use the
  156.       card as a Sound Blaster 16 or earlier.
  157.  
  158.     - Pro Audio Spectrum, Pro Audio Spectrum Plus/16 device drivers:
  159.       These drivers need to have the MVSOUND.SYS driver installed
  160.       in your CONFIG.SYS configuration file. The model of the card
  161.       is determined by hardware checking the card features bits.
  162.  
  163.     - Gravis Ultrasound, Ultrasound MAX device drivers:
  164.       This driver uses the ULTRASND environment variable to determine
  165.       the hardware configuration of your card. For applications using
  166.       the DOS4GW extender, the GF1-IRQ number must be less than 8 to
  167.       work correctly.
  168.  
  169.     - Gravis Ultrasound Daughterboard / MAX (CS4231) device drivers:
  170.       This driver uses the CS4231 codec of your GUS DB/MAX card, so
  171.       you must have the ULTRASND and ULTRA16 environment variables.
  172.  
  173.     - Gravis Ultrasound PnP (Pro), InterWave-based device drivers:
  174.       This driver uses the ULTRASND and INTERWAVE environment variables
  175.       to determine the hardware configuration of your sound board.
  176.       
  177.     - Windows Sound System device driver:
  178.       This driver automatically detect WSS sound devices installed
  179.       at the 530, E80, F40 or 604 I/O base port addresses and uses
  180.       by default the IRQ line #7 and DMA channel #1 for playback.
  181.       Since there can be hardware conflicts, the driver first check
  182.       for the WSSCFG environment variable which has the following
  183.       format:
  184.                   SET WSSCFG=Annn In Dn
  185.                               |    |  |
  186.                               |    |  +-- DMA channel (0,1,3)
  187.                               |    +---- IRQ number (7,9,10,11)
  188.                               +----- I/O port (530,E80,F40,604)
  189.  
  190.       You must write the above command in your AUTOEXEC.BAT start-up
  191.       batch file. Also, some WSS clone devices need to run an utility
  192.       to put the card in WSS mode (ie. MAD16 OPTi-based cards).
  193.  
  194.     - Ensoniq Soundscape, Soundscape Elite device drivers:
  195.       These drivers uses the SNDSCAPE environment variable to read
  196.       the SNDSCAPE.INI configuration file.
  197.  
  198.     - Sierra Semoconductors' Aria sound card driver:
  199.       This driver uses the ARIA environment variable to read the
  200.       hardware configuration parameters.
  201.  
  202.     - Ensoniq AudioPCI and Creative PCI64 sound cards:
  203.       These cards have to be configured in Legacy emulation mode
  204.       under DOS. The library will use these cards as Ensoniq
  205.       SoundScape ISA cards.
  206.  
  207. If you experience any problems, please try avoiding autodetection and
  208. tell your application what device driver to use. Also, ensure your
  209. system has no TSR's loaded in memory (such as SBOS for GUS cards).
  210.  
  211.  
  212. Notes about Windows 95
  213. ----------------------
  214. The SEAL audio system for DOS and Extended DOS has been sucessfully 
  215. tested under Windows 95 DOS boxes running in foreground. However,
  216. some Windows 95 sound drivers might not be able to share the sound
  217. hardware with DOS sessions (such as the Ultrasound drivers). In such
  218. cases, you must either remove the Windows 95 drivers or exit to DOS
  219. to run your DOS programs.
  220.  
  221.  
  222. Notes about Linux
  223. -----------------
  224. The SEAL audio system for Linux uses the UNIX Sound System interface,
  225. also known as the VoxWare Kit. The audio system can be easily ported
  226. to other UNIX operating system running in Intel x86 platforms where
  227. the UNIX Sound System interface is also available, such as FreeBSD, 
  228. 386bsd, SCO and SVR4.2 operating systems.
  229.  
  230.  
  231. Notes about BeOS
  232. ----------------
  233. The SEAL audio library for Intel BeOS Release 3 also works with
  234. New MediaKit sound drivers found on BeOS R4. The SEAL 1.06 library
  235. comes with ELF binaries for Intel BeOS Release 4. 
  236.  
  237.  
  238. Licensing the Software
  239. ----------------------
  240. Please read the file named ORDER.TXT for details about licensing the
  241. SEAL Audio Library for use in shareware or commercial products.
  242.  
  243.  
  244. Contacting the Author
  245. ---------------------
  246. If you have questions, problems or comments you can contact the author 
  247. at the following email address: chasan@dcc.uchile.cl.
  248.  
  249.  
  250. Closing Words
  251. -------------
  252. I would like to thank all the beta testers and specially to Jon L. 
  253. for the music module file used by the example programs, and to all
  254. the IRC friends at the #coders channel.
  255.  
  256.